<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>connection_object_model_3d [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_3dobjectmodel.html">3D Object Model</a> / <a href="toc_3dobjectmodel_transformations.html">变换</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">connection_object_model_3d</span><span data-if="c" style="display:none;">T_connection_object_model_3d</span><span data-if="cpp" style="display:none;">ConnectionObjectModel3d</span><span data-if="dotnet" style="display:none;">ConnectionObjectModel3d</span><span data-if="python" style="display:none;">connection_object_model_3d</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">connection_object_model_3d</span><span data-if="c" style="display:none;">T_connection_object_model_3d</span><span data-if="cpp" style="display:none;">ConnectionObjectModel3d</span><span data-if="dotnet" style="display:none;">ConnectionObjectModel3d</span><span data-if="python" style="display:none;">connection_object_model_3d</span></code> — Determine the connected components of the
3D object model.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>connection_object_model_3d</b>( :  : <a href="#ObjectModel3D"><i>ObjectModel3D</i></a>, <a href="#Feature"><i>Feature</i></a>, <a href="#Value"><i>Value</i></a> : <a href="#ObjectModel3DConnected"><i>ObjectModel3DConnected</i></a>)</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_connection_object_model_3d</b>(const Htuple <a href="#ObjectModel3D"><i>ObjectModel3D</i></a>, const Htuple <a href="#Feature"><i>Feature</i></a>, const Htuple <a href="#Value"><i>Value</i></a>, Htuple* <a href="#ObjectModel3DConnected"><i>ObjectModel3DConnected</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>ConnectionObjectModel3d</b>(const HTuple&amp; <a href="#ObjectModel3D"><i>ObjectModel3D</i></a>, const HTuple&amp; <a href="#Feature"><i>Feature</i></a>, const HTuple&amp; <a href="#Value"><i>Value</i></a>, HTuple* <a href="#ObjectModel3DConnected"><i>ObjectModel3DConnected</i></a>)</code></p>
<p>
<code>static HObjectModel3DArray <a href="HObjectModel3D.html">HObjectModel3D</a>::<b>ConnectionObjectModel3d</b>(const HObjectModel3DArray&amp; <a href="#ObjectModel3D"><i>ObjectModel3D</i></a>, const HTuple&amp; <a href="#Feature"><i>Feature</i></a>, const HTuple&amp; <a href="#Value"><i>Value</i></a>)</code></p>
<p>
<code>HObjectModel3DArray <a href="HObjectModel3D.html">HObjectModel3D</a>::<b>ConnectionObjectModel3d</b>(const HString&amp; <a href="#Feature"><i>Feature</i></a>, double <a href="#Value"><i>Value</i></a>) const</code></p>
<p>
<code>HObjectModel3DArray <a href="HObjectModel3D.html">HObjectModel3D</a>::<b>ConnectionObjectModel3d</b>(const char* <a href="#Feature"><i>Feature</i></a>, double <a href="#Value"><i>Value</i></a>) const</code></p>
<p>
<code>HObjectModel3DArray <a href="HObjectModel3D.html">HObjectModel3D</a>::<b>ConnectionObjectModel3d</b>(const wchar_t* <a href="#Feature"><i>Feature</i></a>, double <a href="#Value"><i>Value</i></a>) const  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>ConnectionObjectModel3d</b>(<a href="HTuple.html">HTuple</a> <a href="#ObjectModel3D"><i>objectModel3D</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Feature"><i>feature</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Value"><i>value</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#ObjectModel3DConnected"><i>objectModel3DConnected</i></a>)</code></p>
<p>
<code>static <a href="HObjectModel3D.html">HObjectModel3D[]</a> <a href="HObjectModel3D.html">HObjectModel3D</a>.<b>ConnectionObjectModel3d</b>(<a href="HObjectModel3D.html">HObjectModel3D[]</a> <a href="#ObjectModel3D"><i>objectModel3D</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Feature"><i>feature</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Value"><i>value</i></a>)</code></p>
<p>
<code><a href="HObjectModel3D.html">HObjectModel3D[]</a> <a href="HObjectModel3D.html">HObjectModel3D</a>.<b>ConnectionObjectModel3d</b>(string <a href="#Feature"><i>feature</i></a>, double <a href="#Value"><i>value</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>connection_object_model_3d</b>(<a href="#ObjectModel3D"><i>object_model_3d</i></a>: MaybeSequence[HHandle], <a href="#Feature"><i>feature</i></a>: MaybeSequence[str], <a href="#Value"><i>value</i></a>: MaybeSequence[Union[int, float]]) -&gt; Sequence[HHandle]</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">connection_object_model_3d</span><span data-if="c" style="display:none">connection_object_model_3d</span><span data-if="cpp" style="display:none">ConnectionObjectModel3d</span><span data-if="com" style="display:none">ConnectionObjectModel3d</span><span data-if="dotnet" style="display:none">ConnectionObjectModel3d</span><span data-if="python" style="display:none">connection_object_model_3d</span></code> determines the connected components
of the input 3D object model given in <a href="#ObjectModel3D"><i><code><span data-if="hdevelop" style="display:inline">ObjectModel3D</span><span data-if="c" style="display:none">ObjectModel3D</span><span data-if="cpp" style="display:none">ObjectModel3D</span><span data-if="com" style="display:none">ObjectModel3D</span><span data-if="dotnet" style="display:none">objectModel3D</span><span data-if="python" style="display:none">object_model_3d</span></code></i></a>. The decision
if two parts of the 3D object model are connected can be based on
different attributes and respective distance functions.
The attribute and distance function can be selected in <a href="#Feature"><i><code><span data-if="hdevelop" style="display:inline">Feature</span><span data-if="c" style="display:none">Feature</span><span data-if="cpp" style="display:none">Feature</span><span data-if="com" style="display:none">Feature</span><span data-if="dotnet" style="display:none">feature</span><span data-if="python" style="display:none">feature</span></code></i></a>:
</p>
<dl class="generic">

<dt><b><i><span data-if="hdevelop" style="display:inline">'distance_3d'</span><span data-if="c" style="display:none">"distance_3d"</span><span data-if="cpp" style="display:none">"distance_3d"</span><span data-if="com" style="display:none">"distance_3d"</span><span data-if="dotnet" style="display:none">"distance_3d"</span><span data-if="python" style="display:none">"distance_3d"</span></i>:</b></dt>
<dd><p>

The euclidean distance between the point coordinates of the
set of the 3D points are tested. For any distance below <a href="#Value"><i><code><span data-if="hdevelop" style="display:inline">Value</span><span data-if="c" style="display:none">Value</span><span data-if="cpp" style="display:none">Value</span><span data-if="com" style="display:none">Value</span><span data-if="dotnet" style="display:none">value</span><span data-if="python" style="display:none">value</span></code></i></a>
the points are considered as connected.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'angle'</span><span data-if="c" style="display:none">"angle"</span><span data-if="cpp" style="display:none">"angle"</span><span data-if="com" style="display:none">"angle"</span><span data-if="dotnet" style="display:none">"angle"</span><span data-if="python" style="display:none">"angle"</span></i>:</b></dt>
<dd>
<p>

The angles between the normals of the points in the 3D object model
are compared. Similar normals are considered as connected if their
angular distance is below <a href="#Value"><i><code><span data-if="hdevelop" style="display:inline">Value</span><span data-if="c" style="display:none">Value</span><span data-if="cpp" style="display:none">Value</span><span data-if="com" style="display:none">Value</span><span data-if="dotnet" style="display:none">value</span><span data-if="python" style="display:none">value</span></code></i></a>. <a href="#Value"><i><code><span data-if="hdevelop" style="display:inline">Value</span><span data-if="c" style="display:none">Value</span><span data-if="cpp" style="display:none">Value</span><span data-if="com" style="display:none">Value</span><span data-if="dotnet" style="display:none">value</span><span data-if="python" style="display:none">value</span></code></i></a> is
specified in radians and should be between 0 and pi. </p>
<p>
Prerequisite:  The 3D object model must contain normals, which can
be computed with <a href="surface_normals_object_model_3d.html"><code><span data-if="hdevelop" style="display:inline">surface_normals_object_model_3d</span><span data-if="c" style="display:none">surface_normals_object_model_3d</span><span data-if="cpp" style="display:none">SurfaceNormalsObjectModel3d</span><span data-if="com" style="display:none">SurfaceNormalsObjectModel3d</span><span data-if="dotnet" style="display:none">SurfaceNormalsObjectModel3d</span><span data-if="python" style="display:none">surface_normals_object_model_3d</span></code></a>.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'distance_mapping'</span><span data-if="c" style="display:none">"distance_mapping"</span><span data-if="cpp" style="display:none">"distance_mapping"</span><span data-if="com" style="display:none">"distance_mapping"</span><span data-if="dotnet" style="display:none">"distance_mapping"</span><span data-if="python" style="display:none">"distance_mapping"</span></i>:</b></dt>
<dd>
<p>

The mapping measures the distance between the pixel coordinates of
points in the 3D object model that are stored in the 2D mapping.
Use  a value larger than 1.5  for <a href="#Value"><i><code><span data-if="hdevelop" style="display:inline">Value</span><span data-if="c" style="display:none">Value</span><span data-if="cpp" style="display:none">Value</span><span data-if="com" style="display:none">Value</span><span data-if="dotnet" style="display:none">value</span><span data-if="python" style="display:none">value</span></code></i></a> to get a connection
in an 8-neighborhood in the image. </p>
<p>
Prerequisite: The 3D object model must contain a 2D mapping, which is
available if the 3D object model has been created with
<a href="xyz_to_object_model_3d.html"><code><span data-if="hdevelop" style="display:inline">xyz_to_object_model_3d</span><span data-if="c" style="display:none">xyz_to_object_model_3d</span><span data-if="cpp" style="display:none">XyzToObjectModel3d</span><span data-if="com" style="display:none">XyzToObjectModel3d</span><span data-if="dotnet" style="display:none">XyzToObjectModel3d</span><span data-if="python" style="display:none">xyz_to_object_model_3d</span></code></a>.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'mesh'</span><span data-if="c" style="display:none">"mesh"</span><span data-if="cpp" style="display:none">"mesh"</span><span data-if="com" style="display:none">"mesh"</span><span data-if="dotnet" style="display:none">"mesh"</span><span data-if="python" style="display:none">"mesh"</span></i>:</b></dt>
<dd>
<p>

Returns parts of the 3D object model that are connected with
triangles or polygons. <a href="#Value"><i><code><span data-if="hdevelop" style="display:inline">Value</span><span data-if="c" style="display:none">Value</span><span data-if="cpp" style="display:none">Value</span><span data-if="com" style="display:none">Value</span><span data-if="dotnet" style="display:none">value</span><span data-if="python" style="display:none">value</span></code></i></a> is ignored.  </p>
<p>
Prerequisite: The 3D object model must provide a triangulation, which can
be obtained with <a href="triangulate_object_model_3d.html"><code><span data-if="hdevelop" style="display:inline">triangulate_object_model_3d</span><span data-if="c" style="display:none">triangulate_object_model_3d</span><span data-if="cpp" style="display:none">TriangulateObjectModel3d</span><span data-if="com" style="display:none">TriangulateObjectModel3d</span><span data-if="dotnet" style="display:none">TriangulateObjectModel3d</span><span data-if="python" style="display:none">triangulate_object_model_3d</span></code></a>. Alternatively,
if the 3D object model already contains a 2D mapping,
<a href="prepare_object_model_3d.html"><code><span data-if="hdevelop" style="display:inline">prepare_object_model_3d</span><span data-if="c" style="display:none">prepare_object_model_3d</span><span data-if="cpp" style="display:none">PrepareObjectModel3d</span><span data-if="com" style="display:none">PrepareObjectModel3d</span><span data-if="dotnet" style="display:none">PrepareObjectModel3d</span><span data-if="python" style="display:none">prepare_object_model_3d</span></code></a> can be used with
<code><span data-if="hdevelop" style="display:inline">Purpose</span><span data-if="c" style="display:none">Purpose</span><span data-if="cpp" style="display:none">Purpose</span><span data-if="com" style="display:none">Purpose</span><span data-if="dotnet" style="display:none">purpose</span><span data-if="python" style="display:none">purpose</span></code> set to <i><span data-if="hdevelop" style="display:inline">'segmentation'</span><span data-if="c" style="display:none">"segmentation"</span><span data-if="cpp" style="display:none">"segmentation"</span><span data-if="com" style="display:none">"segmentation"</span><span data-if="dotnet" style="display:none">"segmentation"</span><span data-if="python" style="display:none">"segmentation"</span></i>
to quickly triangulate the 3D object model.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'lines'</span><span data-if="c" style="display:none">"lines"</span><span data-if="cpp" style="display:none">"lines"</span><span data-if="com" style="display:none">"lines"</span><span data-if="dotnet" style="display:none">"lines"</span><span data-if="python" style="display:none">"lines"</span></i>:</b></dt>
<dd>
<p>

Returns parts of the object model that are connected by lines.
<a href="#Value"><i><code><span data-if="hdevelop" style="display:inline">Value</span><span data-if="c" style="display:none">Value</span><span data-if="cpp" style="display:none">Value</span><span data-if="com" style="display:none">Value</span><span data-if="dotnet" style="display:none">value</span><span data-if="python" style="display:none">value</span></code></i></a> is ignored. </p>
<p>
Prerequisite: The 3D object model must contain polylines, which can be
computed with <a href="intersect_plane_object_model_3d.html"><code><span data-if="hdevelop" style="display:inline">intersect_plane_object_model_3d</span><span data-if="c" style="display:none">intersect_plane_object_model_3d</span><span data-if="cpp" style="display:none">IntersectPlaneObjectModel3d</span><span data-if="com" style="display:none">IntersectPlaneObjectModel3d</span><span data-if="dotnet" style="display:none">IntersectPlaneObjectModel3d</span><span data-if="python" style="display:none">intersect_plane_object_model_3d</span></code></a>.
</p>
</dd>
</dl>
<p>Alternatively, the required attributes can be set manually with
<a href="set_object_model_3d_attrib.html"><code><span data-if="hdevelop" style="display:inline">set_object_model_3d_attrib</span><span data-if="c" style="display:none">set_object_model_3d_attrib</span><span data-if="cpp" style="display:none">SetObjectModel3dAttrib</span><span data-if="com" style="display:none">SetObjectModel3dAttrib</span><span data-if="dotnet" style="display:none">SetObjectModel3dAttrib</span><span data-if="python" style="display:none">set_object_model_3d_attrib</span></code></a> or
<a href="set_object_model_3d_attrib_mod.html"><code><span data-if="hdevelop" style="display:inline">set_object_model_3d_attrib_mod</span><span data-if="c" style="display:none">set_object_model_3d_attrib_mod</span><span data-if="cpp" style="display:none">SetObjectModel3dAttribMod</span><span data-if="com" style="display:none">SetObjectModel3dAttribMod</span><span data-if="dotnet" style="display:none">SetObjectModel3dAttribMod</span><span data-if="python" style="display:none">set_object_model_3d_attrib_mod</span></code></a>. Note that the 3D object model might
already contain the required attribute, especially if the 3D object model
has been read with <a href="read_object_model_3d.html"><code><span data-if="hdevelop" style="display:inline">read_object_model_3d</span><span data-if="c" style="display:none">read_object_model_3d</span><span data-if="cpp" style="display:none">ReadObjectModel3d</span><span data-if="com" style="display:none">ReadObjectModel3d</span><span data-if="dotnet" style="display:none">ReadObjectModel3d</span><span data-if="python" style="display:none">read_object_model_3d</span></code></a> or if it has been
deserialized with <a href="deserialize_object_model_3d.html"><code><span data-if="hdevelop" style="display:inline">deserialize_object_model_3d</span><span data-if="c" style="display:none">deserialize_object_model_3d</span><span data-if="cpp" style="display:none">DeserializeObjectModel3d</span><span data-if="com" style="display:none">DeserializeObjectModel3d</span><span data-if="dotnet" style="display:none">DeserializeObjectModel3d</span><span data-if="python" style="display:none">deserialize_object_model_3d</span></code></a>. To check whether the
required attribute is available, use <a href="get_object_model_3d_params.html"><code><span data-if="hdevelop" style="display:inline">get_object_model_3d_params</span><span data-if="c" style="display:none">get_object_model_3d_params</span><span data-if="cpp" style="display:none">GetObjectModel3dParams</span><span data-if="com" style="display:none">GetObjectModel3dParams</span><span data-if="dotnet" style="display:none">GetObjectModel3dParams</span><span data-if="python" style="display:none">get_object_model_3d_params</span></code></a>.
</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  
    <li>Automatically parallelized on internal data level.</li>
  
</ul>
<p>This operator supports canceling timeouts and interrupts.</p>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="ObjectModel3D" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ObjectModel3D</span><span data-if="c" style="display:none">ObjectModel3D</span><span data-if="cpp" style="display:none">ObjectModel3D</span><span data-if="com" style="display:none">ObjectModel3D</span><span data-if="dotnet" style="display:none">objectModel3D</span><span data-if="python" style="display:none">object_model_3d</span></code></b> (input_control)  </span><span>object_model_3d(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HObjectModel3D.html">HObjectModel3D</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[HHandle]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Handle of the 3D object model.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Feature" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Feature</span><span data-if="c" style="display:none">Feature</span><span data-if="cpp" style="display:none">Feature</span><span data-if="com" style="display:none">Feature</span><span data-if="dotnet" style="display:none">feature</span><span data-if="python" style="display:none">feature</span></code></b> (input_control)  </span><span>string(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Attribute used to calculate the connected
components.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'distance_3d'</span>
    <span data-if="c" style="display:none">"distance_3d"</span>
    <span data-if="cpp" style="display:none">"distance_3d"</span>
    <span data-if="com" style="display:none">"distance_3d"</span>
    <span data-if="dotnet" style="display:none">"distance_3d"</span>
    <span data-if="python" style="display:none">"distance_3d"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'angle'</span><span data-if="c" style="display:none">"angle"</span><span data-if="cpp" style="display:none">"angle"</span><span data-if="com" style="display:none">"angle"</span><span data-if="dotnet" style="display:none">"angle"</span><span data-if="python" style="display:none">"angle"</span>, <span data-if="hdevelop" style="display:inline">'distance_3d'</span><span data-if="c" style="display:none">"distance_3d"</span><span data-if="cpp" style="display:none">"distance_3d"</span><span data-if="com" style="display:none">"distance_3d"</span><span data-if="dotnet" style="display:none">"distance_3d"</span><span data-if="python" style="display:none">"distance_3d"</span>, <span data-if="hdevelop" style="display:inline">'distance_mapping'</span><span data-if="c" style="display:none">"distance_mapping"</span><span data-if="cpp" style="display:none">"distance_mapping"</span><span data-if="com" style="display:none">"distance_mapping"</span><span data-if="dotnet" style="display:none">"distance_mapping"</span><span data-if="python" style="display:none">"distance_mapping"</span>, <span data-if="hdevelop" style="display:inline">'lines'</span><span data-if="c" style="display:none">"lines"</span><span data-if="cpp" style="display:none">"lines"</span><span data-if="com" style="display:none">"lines"</span><span data-if="dotnet" style="display:none">"lines"</span><span data-if="python" style="display:none">"lines"</span>, <span data-if="hdevelop" style="display:inline">'mesh'</span><span data-if="c" style="display:none">"mesh"</span><span data-if="cpp" style="display:none">"mesh"</span><span data-if="com" style="display:none">"mesh"</span><span data-if="dotnet" style="display:none">"mesh"</span><span data-if="python" style="display:none">"mesh"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Value" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Value</span><span data-if="c" style="display:none">Value</span><span data-if="cpp" style="display:none">Value</span><span data-if="com" style="display:none">Value</span><span data-if="dotnet" style="display:none">value</span><span data-if="python" style="display:none">value</span></code></b> (input_control)  </span><span>number(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[Union[int, float]]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real / </span><span data-if="hdevelop" style="display:inline">integer)</span><span data-if="dotnet" style="display:none"> (<i>double</i> / </span><span data-if="dotnet" style="display:none">int / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>double</i> / </span><span data-if="cpp" style="display:none">Hlong)</span><span data-if="c" style="display:none"> (<i>double</i> / </span><span data-if="c" style="display:none">Hlong)</span></span>
</div>
<p class="pardesc">Maximum value for the distance between two
connected components.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>1.0</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>1.0, 1.1, 1.5, 10.0, 100.0</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ObjectModel3DConnected" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ObjectModel3DConnected</span><span data-if="c" style="display:none">ObjectModel3DConnected</span><span data-if="cpp" style="display:none">ObjectModel3DConnected</span><span data-if="com" style="display:none">ObjectModel3DConnected</span><span data-if="dotnet" style="display:none">objectModel3DConnected</span><span data-if="python" style="display:none">object_model_3dconnected</span></code></b> (output_control)  </span><span>object_model_3d-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HObjectModel3D.html">HObjectModel3D</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[HHandle]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Handle of the 3D object models that represent
the connected components.</p>
</div>
<h2 id="sec_example_all">例程 (HDevelop)</h2>
<pre class="example">
gen_object_model_3d_from_points (rand(100), rand(100),\
                                 rand(100), ObjectModel3D)
connection_object_model_3d (ObjectModel3D, 'distance_3d', 0.2,\
                            ObjectModel3DConnected)
dev_get_window (WindowHandle)
visualize_object_model_3d (WindowHandle, [ObjectModel3DConnected], [], [],\
                           ['colored'], [12], [], [], [], PoseOut)
</pre>
<h2 id="sec_result">结果</h2>
<p><code><span data-if="hdevelop" style="display:inline">connection_object_model_3d</span><span data-if="c" style="display:none">connection_object_model_3d</span><span data-if="cpp" style="display:none">ConnectionObjectModel3d</span><span data-if="com" style="display:none">ConnectionObjectModel3d</span><span data-if="dotnet" style="display:none">ConnectionObjectModel3d</span><span data-if="python" style="display:none">connection_object_model_3d</span></code> returns <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
     if all parameters
are correct. 如有必要，将引发异常。</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="read_object_model_3d.html"><span data-if="hdevelop" style="display:inline">read_object_model_3d</span><span data-if="c" style="display:none">read_object_model_3d</span><span data-if="cpp" style="display:none">ReadObjectModel3d</span><span data-if="com" style="display:none">ReadObjectModel3d</span><span data-if="dotnet" style="display:none">ReadObjectModel3d</span><span data-if="python" style="display:none">read_object_model_3d</span></a></code>, 
<code><a href="xyz_to_object_model_3d.html"><span data-if="hdevelop" style="display:inline">xyz_to_object_model_3d</span><span data-if="c" style="display:none">xyz_to_object_model_3d</span><span data-if="cpp" style="display:none">XyzToObjectModel3d</span><span data-if="com" style="display:none">XyzToObjectModel3d</span><span data-if="dotnet" style="display:none">XyzToObjectModel3d</span><span data-if="python" style="display:none">xyz_to_object_model_3d</span></a></code>, 
<code><a href="select_points_object_model_3d.html"><span data-if="hdevelop" style="display:inline">select_points_object_model_3d</span><span data-if="c" style="display:none">select_points_object_model_3d</span><span data-if="cpp" style="display:none">SelectPointsObjectModel3d</span><span data-if="com" style="display:none">SelectPointsObjectModel3d</span><span data-if="dotnet" style="display:none">SelectPointsObjectModel3d</span><span data-if="python" style="display:none">select_points_object_model_3d</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="project_object_model_3d.html"><span data-if="hdevelop" style="display:inline">project_object_model_3d</span><span data-if="c" style="display:none">project_object_model_3d</span><span data-if="cpp" style="display:none">ProjectObjectModel3d</span><span data-if="com" style="display:none">ProjectObjectModel3d</span><span data-if="dotnet" style="display:none">ProjectObjectModel3d</span><span data-if="python" style="display:none">project_object_model_3d</span></a></code>, 
<code><a href="object_model_3d_to_xyz.html"><span data-if="hdevelop" style="display:inline">object_model_3d_to_xyz</span><span data-if="c" style="display:none">object_model_3d_to_xyz</span><span data-if="cpp" style="display:none">ObjectModel3dToXyz</span><span data-if="com" style="display:none">ObjectModel3dToXyz</span><span data-if="dotnet" style="display:none">ObjectModel3dToXyz</span><span data-if="python" style="display:none">object_model_3d_to_xyz</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="select_object_model_3d.html"><span data-if="hdevelop" style="display:inline">select_object_model_3d</span><span data-if="c" style="display:none">select_object_model_3d</span><span data-if="cpp" style="display:none">SelectObjectModel3d</span><span data-if="com" style="display:none">SelectObjectModel3d</span><span data-if="dotnet" style="display:none">SelectObjectModel3d</span><span data-if="python" style="display:none">select_object_model_3d</span></a></code>, 
<code><a href="select_points_object_model_3d.html"><span data-if="hdevelop" style="display:inline">select_points_object_model_3d</span><span data-if="c" style="display:none">select_points_object_model_3d</span><span data-if="cpp" style="display:none">SelectPointsObjectModel3d</span><span data-if="com" style="display:none">SelectPointsObjectModel3d</span><span data-if="dotnet" style="display:none">SelectPointsObjectModel3d</span><span data-if="python" style="display:none">select_points_object_model_3d</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
3D Metrology</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
